home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Misc Utils / Lowdown Folder / Newton Lowdown / Newton Lowdown.rsrc / TEXT_-15776_NewtonScriptLowdown.txt < prev    next >
Text File  |  1993-08-11  |  6KB  |  153 lines
  1. The Lowdown on Newton‚Ñ¢
  2. An introduction to Newton error messages
  3. and basic NewtonScript‚Ñ¢ programming
  4.  
  5. Exception Types
  6. In some error codes, you may see reference to NewtonScript 'frames'.
  7. Those identified could include:
  8. |evt.ex.fr|                                  a frames exception
  9. |evt.ex.fr;type.ref.frame|          a frames exception with frame data
  10. |evt.ex.fr.type|                          an exception generated by a bad data type
  11. |evt.ex.fr.type;type.ref.frame|   a similar bad type exception, with frame data
  12. |evt.ex.fr.comp|                          an exception from the compiler
  13. |evt.ex.fr.intrp|                          an exception from the interpreter
  14. |evt.ex.fr.intrp;type.ref.frame|  an exception from the interpreter, with frame data
  15. |evt.ex.fr.store|                          an exception for the storage manager.
  16.  
  17. Error Codes
  18. Store Errors - related to stores
  19. NOTE: the 'soup' is the database of 'persistent' objects in the store
  20. -48002    store format is too old to understand
  21. -48003    store format is too new to understand
  22. -48004    store is corrupted, cannot recover
  23. -48005    single object is corrupted, cannot recover
  24. -48009    not a soup entry
  25. -48010    tried to remove a store that was not registered
  26. -48011    soup index has an unknown type
  27. -48012    soup index has an unknown key structure
  28. -48013    soup index does not exist
  29. -48014    a soup with this name already exists
  30. -48015    tried to CopyEntries to an unknown soup
  31. -48016    soup is invalid (probably from a removed store)
  32. -48017    soup is invalid (probably from a removed store)
  33. -48018    entry is invalid (probably from a removed store)
  34. -48019    key does not have the type specified in the index
  35. -48020    store is in ROM
  36. -48021    soup already has an index with this path
  37. -48022    internal error - something unexpected happened
  38.                 (probably hit by a Holy Hand-Grenade)
  39. -48023    tried to call RemoveIndex on the _uniqueID index
  40. -48024    query type missing or unknown
  41. -48025    discovered index inconsistency
  42.  
  43. Object System Errors
  44. -48200    expected a frame, array, or binary object,
  45.                 but got something else
  46. -48202    empty path
  47. -48203    invalid segment in path expression
  48. -48204    path failed
  49. -48205    index out of bounds (string or array)
  50. -48206    source and destination must be different objects
  51. -48207    long out of range (too large or small)
  52. -48210    bad arguments
  53. -48211    string too big
  54. -48214    object is read-only
  55. -48215    functionality is unimplemented
  56.  
  57. Bad Type Errors
  58. -48400    expected a frame
  59. -48401    expected an array
  60. -48402    expected a string
  61. -48403    expected a pointer
  62. -48404    expected a number
  63. -48405    expected a real
  64. -48406    expected an integer
  65. -48407    expected a character
  66. -48408    expected a binary object
  67. -48409    expected a path expression
  68.                 (or a symbol or integer)
  69. -48410    expected a symbol
  70. -48411    expected a symbol
  71. -48412    expected a frame or an array
  72. -48413    expected an array or Nil
  73. -48414    expected a string or Nil
  74. -48415    expected a binary object or Nil
  75. -48416    unexpected frame
  76. -48417    unexpected binary object
  77. -48418    unexpected immediate
  78. -48499    unexpected Spanish Inquisition
  79.  
  80. Interpreter Errors
  81. -48800    not in a break loop, but presumably called break
  82. -48802    too many arguments for a CFunction
  83. -48803    wrong number of arguments
  84. -48804    FOR loop BY expression has value zero
  85. -48806    no current exception
  86. -48807    undefined variable
  87. -48808    undefined global function
  88. -48809    undefined method
  89. -48810    no _proto for inherited send
  90. -48811    tried to access slot in Nil context
  91. -48814    local variables and FOR/WITH loops are not
  92.                 allowed at top level
  93.  
  94. NewtonScript Data Types
  95. integers - in the range -(2^29 - 1) to 2^29 - 1.  Can be represented in
  96. hexadecimal, using the format 0xNNNN, e.g. 0x1F4A.
  97.  
  98. reals - SANE double floating point numbers, 15-16 digit, with
  99. exponents in the range -308 to 308.  Must be given as a number with
  100. a decimal point (e.g. 4. and 6.9035) or in exponential form (e.g. 4.55e7).
  101.  
  102. characters - given as e.g. $a for 'a', $7 for '7', or in unicode escape chars.
  103.  
  104. NewtonScript Integer Math
  105. <<           shift left
  106. >>           shift right
  107. *            multiply
  108. div         integer divide
  109. mod        remainder divide
  110. +            add
  111. -            subtract
  112. Random(low, high) returns a random number between low and high.
  113.  
  114. NewtonScript Floating Point Math
  115. *            multiply
  116. /            floating point divide
  117. +            add
  118. -            subtract
  119. Unary (arity 1) functions are used as 'function(argument)' and include:
  120. Acos, Asin, Atan, Cos, Cosh, Exp, Log, Log10, Sin, Sinh, Sqrt, Tan, Tanh,
  121. Acosh, Asinh, Atanh, Erf, Erfc, Expm1, Gamma, LGamma, Logb, Log1p.
  122.  
  123. Binary (arity 2) functions are used as 'function(arg1, arg2)' and include:
  124. Atan2(x,y), Fmod(x,y), Pow(x,y), Hypot(x,y), Remainder(x,y),
  125. Annuity(rate,periods), Compound(rate,periods).
  126.  
  127. Ord(char) returns the Unicode value of the character passed.
  128. Chr(unicode) returns the character for a given Unicode value.
  129.  
  130. NewtonScript Miscellanea
  131. GC() calls a garbage collection of memory.
  132.  
  133. Caution
  134. Using NewtonScript directly into a Newton device may damage your, and your Newton's, health.
  135. You should only attempt to do what you know yourself to be capable of.  Only run NewtonScript
  136. programs on a Newton which has been fully backed up using a reliable method.  You have been
  137. warned!
  138.  
  139. NewtonScript is a trademark of Apple Computer, Inc.  The information provided here has been
  140. drawn from manuals which are ¬© Apple Computer, Inc.  The copyright
  141. holder should be consulted for permission for any further reproduction.
  142.  
  143. These shortcuts have been compiled by Howard Oakley of EHN & DIJ Oakley
  144. They are presented in good faith and without liability, but with the occasional help
  145. of the Monty Python team
  146.  
  147. Contact EHN & DIJ Oakley
  148. V oice: +44 983 853605
  149. Fax:     +44 983 853253
  150. CompuServe: 70734,120
  151. AppleLink:     UK0392
  152. Internet:        Howard@quercus.demon.co.uk
  153. 11 August 1993